home *** CD-ROM | disk | FTP | other *** search
/ F1 Licenseware / F1 Licenseware - Volume 1.iso / disks / 003.dms / 003.adf / TEXT / chapter19.txt < prev    next >
Text File  |  1992-09-02  |  4KB  |  131 lines
  1.  
  2.               The Absolute Beginners Guide To Amos
  3.               -------------------------------------
  4.                          Chapter Nineteen
  5.                          ----------------
  6.  
  7. In this chapter I will be covering the more important of Amos`s drawing 
  8. commands.
  9.  
  10. PLOT
  11. ----
  12. Looking at the Amos manual I can`t think of any other way to explain this
  13. simple command.  PLOT draws a single pixel of colour on your screen at the
  14. specified coordinates i.e.
  15.  
  16. PLOT 0,0
  17.  
  18. Would PLOT a pixel of the current INK colour at the very top left hand edge
  19. of your screen.  The X coordinates (Across) Range from 0 to 319 and the Y
  20. coords from 0 to 199 (the second 0 in the example).
  21.  
  22. Just a quick word about INK, which we haven`t covered yet. 
  23. The reason I haven`t explained the INK command so far was to save confusion
  24. with the PEN command.
  25. PEN, if you remember, controls the colour of PRINTED text.  
  26. INK on the other hand controls the colour of graphic drawing operations like
  27. PLOT and the rest of the commands we will be examining in this chapter.  
  28. INk also controls the colours of another command called TEXT, but forget that
  29. for now.
  30.  
  31. So, getting back to PLOT, we can add an INK option to the PLOT command like 
  32. this:
  33.  
  34. PLOT 0,0,1
  35.  
  36. This will PLOT a pixel at 0,0 in INK colour 1.  
  37.  
  38. Try typing this line into Amos.
  39.  
  40. FOR A=1 to 1000: PLOT RND(319), RND(199),RND(15): NEXT A
  41.  
  42. You should be able to work out exactly what this line does, if not check 
  43. out each command from previous chapters.  As an exercise try doing a
  44. break down of this line yourself, saves me doing it!
  45.  
  46. DRAW
  47. ----
  48. DRAW a line.  The DRAW command is virtually the same set up as PLOT except
  49. you must give a second set of coordinates.  The start of your line and the
  50. end coordinates of your line:
  51.  
  52. DRAW 0,0 TO 100,0
  53.  
  54. Will DRAW a straight line 100 pixels long from the top left hand edge of your
  55. screen.  DRAW uses the current INK setting as it`s colour.
  56. You can DRAW some nice patterns with this command see EXAMPLE19.Amos for some
  57. ideas.
  58.  
  59. As we have covered screen coordinates quite a lot, from now on I will 
  60. refer to any set of coordinates as X and Y.  X is across the screen and Y is 
  61. up or down the screen.  For example:
  62.  
  63. PLOT x,y
  64.  
  65. DRAW x1,y1 TO  x2,y2
  66.  
  67. X just means insert your x coordinate here and the y, the y coordinates.
  68. x1,y1 to x2,y2 simply means the second set of x,y coordinates in the same 
  69. command.
  70.  
  71. Why am I complicating things? Well this is standard practice and you will 
  72. need to know this to understand the Amos manual and other more advanced 
  73. tutorials.
  74.  
  75. BOX
  76. ---
  77. Here is a very useful and easy to use command.  
  78. BOX draws a BOX on screen at the specified coordinates:
  79.  
  80. BOX x1,y1 TO x2,y2
  81.  
  82. X1,Y1 are the coordinates of the top left hand edge of the box.
  83. X2,Y2 are the coordinates of bottom right edge of your box.
  84. See EXAMPLE19.Amos for the BOX command in action.
  85.  
  86.  
  87. CIRCLE x,y,r
  88. ------------
  89. The CIRCLE command, believe it not, draws a triangle on the screen!!! Only
  90. kidding, it draws a CIRCLE of course.  X an Y are the coordinates of the 
  91. centre of the circle and R stands for the radius (size) of the circle.
  92. For example:
  93.  
  94. CIRCLE 100,90,50
  95.  
  96. The dead centre of the circle will be 100 across and 90 pixels down the
  97. screen and the radius will be 50 pixels.  See EXAMPLE19.Amos
  98.  
  99.  
  100. BAR x1,y1 TO  x2,y2
  101. -------------------
  102. This command draws a filled rectangle (a bar) using the same coordinates 
  103. system as DRAW.
  104.  
  105. In any of the above commands you can leave out the x,y coordinates altogether
  106. but you must leave a comma in each place instead like this:
  107.  
  108. PLOT ,
  109.  
  110. What Amos will do in this case is PLOT a pixel at the current position of the
  111. GRAPHICS CURSOR, do not confuse this with the TEXT CURSOR.
  112. This is useful to remember as a lot of other Amos commands utilize this 
  113. trick.  Check the manual for which commands use this.
  114.  
  115. If you need to find out the current position of the graphics cursor then 
  116. you can use the XGR and YGR commands:
  117.  
  118. X=XGR
  119. Y=YGR
  120.  
  121. Now X will hold the X coordinate and Y the Y coordinate of the graphics
  122. cursors current position.
  123.  
  124. There are quite a few more drawing functions in Amos, most people will never
  125. use more than I have described here so I think I have taken you far enough
  126. down this road, for now at least.
  127.  
  128.  
  129.  
  130. End of chapter nineteen.  
  131.